home *** CD-ROM | disk | FTP | other *** search
/ Amiga News 95 / Amiga News 95.iso / dpat / dpat18 / sizer / sizer.doc < prev    next >
Text File  |  1992-11-21  |  8KB  |  210 lines
  1.  
  2.  
  3.                               S I Z E R    D O C
  4.  
  5.  
  6.                                  Gérard CORNU
  7.  
  8.  
  9.                           (version 0.38,  20-Nov-92)
  10.  
  11.  
  12.    Sizer is ©1992 Gérard Cornu, but freely redistributable. When re-
  13.    distributing don't forget to include this unmodified doc file. And
  14.    don't charge more than the cost of an AmigaLib disk from Fred FISH.
  15.  
  16.    This program cannot be used for commercial purposes, or included on
  17.    magazine's cover disks, apart from "AMIGA DP" (a french magasine
  18.    exclusively dedicated to AMiga PD), without the written permission 
  19.    of the author.
  20.  
  21.    Peter Miles (see end of file*) is obviously granted permission to
  22.    include it in any ICPUG Amiga library disk ;-).
  23.  
  24.    Fred Fish is obviously allowed to include it in its unique 
  25.    AmigaLibDisk library.
  26.  
  27.    Thierry Colin ("Amiga DP", see above) is authorised to include it 
  28.    in the french Amiga PD collection "DPAT" (Domaine Public Amiga 
  29.    Toulouse).
  30.  
  31.  
  32.  
  33. Important note:
  34. ~~~~~~~~~~~~~~~
  35.       Contradictory to what I said on the previous docs and Contents :-( 
  36.       'Sizer' is not 'pure', so don't try to make it resident. 
  37.       My apologies for the misinformation. If you want it to be 'pure' 
  38.       just let me know!
  39.  
  40.  
  41. What is sizer ?
  42. ~~~~~~~~~~~~~~~
  43.       Sizer is a quick and small  CLI  utility for getting the size of
  44.       any devices, directories or 'assigns'. It accepts any number
  45.       of arguments. (Well, with some limits!)
  46.  
  47.       I have been using it in 2.04 only but it doesn't use (as yet...)
  48.       any 2.04 features, so this beta version should also work in 1.3.
  49.  
  50.  
  51. How to use it?
  52. ~~~~~~~~~~~~~~
  53.  
  54.       As I said earlier it's a CLI (Shell) thingy.
  55.  
  56.       The format has changed: The '-n' option has disappeared, and it
  57.       ~~~~~~~~~~~~~~~~~~~~~~~
  58.       doen't accept file(s) as arguments, any more.
  59.       
  60.          sizer [-v] {< device | directory | assign >}
  61.  
  62.       The -v option is for displaying the filenames being sized.
  63.  
  64.       This gives much slower results, obviously.
  65.  
  66.       examples:
  67.  
  68.          sizer dh0:
  69.  
  70.          sizer -v MyDirectory
  71.  
  72.          sizer tools/mytooldir
  73.  
  74.          sizer ram:  sys:c  another_device:   etc...
  75.  
  76.       Don't use the '/' at the end of a directory name, but on the
  77.       other hand, you MUST use ':' at the end of a device or assigned
  78.       directory.
  79.  
  80.       To break Sizer, just press 'CTRL C'. If sizer is sizing verbosly,
  81.       with the -v option, you have to hold the CTRL key and keep hitting
  82.       the C key repeatedly, till it finally decides to break, it will,
  83.       if you insist enough!
  84.  
  85.       Sizer is best used with a directory utility. Even better with one
  86.       which accepts multiple arguments.  'Pity  DirWork don't, at least
  87.       not in version 1.62, the one I currently use. SID 2.0 very probably
  88.       has already got such a thing, with the 'bytes' button.
  89.  
  90.       I shall give you the settings I have used to configure it with
  91.       DirWork 1.62:
  92.  
  93.       - Go in the configuration editor (1st top left menu).
  94.  
  95.       - Click on an unused button (in the top bank).
  96.  
  97.       - and fill the following boxes:
  98.  
  99.             Button text:   Size  (or whatever name you fancy!)
  100.  
  101.             Function:      u     (lower case)
  102.  
  103.             Selection:     D     (Upper case) Note: this has changed!
  104.  
  105.             SpecialOp:     ,     (comma)
  106.  
  107.             Option:        p     (lower case)
  108.  
  109.             Arguments:     (full path and name for sizer, plus -v if you
  110.                            like slowliness!.
  111.  
  112.                            Dont use 'Run >NIL:', RunBack or even 'Run' on 
  113.                            its own)
  114.  
  115.       - Click on 'Quit and use'
  116.  
  117.       - Once back to DirWork, save the new configuration.
  118.  
  119.       - That's it!
  120.  
  121.       - Now pick any dir in one of the file lists, then click
  122.         on the 'Size' button. A  window  should  open and 'sizer' will
  123.         display something like this:
  124.  
  125.       sizing quietly...                                      
  126.                                                              
  127.       ram:... 
  128.                                                         
  129.                Total number of files                  26             
  130.                Total number of directories             8             
  131.                Total number of bytes in files      10466             
  132.                Total number of blocks used            67             
  133.                                                        
  134.                                Total occupied :    68608 bytes, 67K. 
  135.                                                                   
  136.  
  137.       I wont explain the 1st line, for the second one, it includes
  138.       all the sub-directories and sub-sub-sub... directories if any.
  139.  
  140.       The 3rd line tells you the total number of bytes of all the files
  141.       and the 4th the total number of blocks all the files, directories,
  142.       subdirectories, sub-sub...directories occupy on their respective
  143.       device.
  144.  
  145.       Suppose you have 'sized' a directory containing 10 files with
  146.       a size of 256 bytes each. The 3rd line will tell you 2560 bytes,
  147.       but the 4th will say 20 blocks, 10 for the files themselves, plus
  148.       1 block for the 'File Header' for each file, which gives a total
  149.       of 20 blocks. Suppose the  device on which those files are kept
  150.       have a block  size  of  512  bytes, the total occupied will
  151.       be 10240 bytes.
  152.  
  153.       For each item it scans, 'sizer' looks at the block size of the
  154.       containing device and calculate the occupied size accordingly.
  155.       
  156.       BTW, using sizer, I discovered that the  block size of the Ram:
  157.       device is actually 1024 bytes (with KickStart 37.175). Most other
  158.       devices, hard disks, floppies have a block size of 512 bytes, but
  159.       I heard (read!) one might be able to change the block size with
  160.       the new FastFileSystem...
  161.  
  162.  
  163.  
  164. Credits!
  165. ~~~~~~~~
  166.  
  167.       This little utility was written with GREAT help from an article by
  168.       Paul OVERAA published by Amiga Format in the december 1990 issue,
  169.       page 209+.
  170.  
  171.       Sizer was written for myself, to help me file all the stuff (*freely
  172.       redistributable*) I got from the great Peter MILES ¤
  173.  
  174.  
  175.  
  176.   |~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~|
  177.   |  Send any bug report, compliment ;-), chocolates, freely distributable |
  178.   |  software, 1Gb hard disks, A3 48 bits colour scanners, brand new       |
  179.   |  AMIGA 4000 with 68060 CPU, etc...                                     |
  180.   |                                                                        |
  181.   |  OR SIMPLY A POST CARD to:                                             |
  182.   |                                                                        |
  183.   |                       Gérard CORNU                                     |
  184.   |                       11 avenue Edouard Aynard                         |
  185.   |                       69130 ECULLY                                     |
  186.   |                                                                        |
  187.   |                       FRANCE.                                          |
  188.   |                                                                        |
  189.   |                                                                        |
  190.   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  191.  
  192.  
  193.  
  194.                     Have plenty of nice days! ... me too!
  195.  
  196.  
  197.  
  198.     ¤ Peter Miles: ICPUG Amiga library organiser, (among other 
  199.                    responsibilities!).
  200.  
  201.       ICPUG is the one and only Independent Commodore Products Users Group.
  202.  
  203.       To become a member of this brilliant club contact:
  204.  
  205.       Jack COHEN, ICPUG Membership secretary, P.O. Box 1309,
  206.       LONDON, N3 2UT, ENGLAND, EUROPE.
  207.  
  208.  
  209.  
  210.